@database ACal
@$VER: ACal.guide 1.2 (1.11.95)
@(C) Denis GALIANA
@author Denis GALIANA
@node main "ACal v1.2"
@next introduction
@toc main
                                @{b}ACal 1.2@{ub}
                               ===========
                @{b}ACal@{ub} is Copyright 
 1994,95 @{"Denis GALIANA" link author}.
                          All rights reserved.
                         @{"      Introduction     " link introduction}
                         @{" Required configuration" link requirements}
                         @{"      Installation     " link installation}
                         @{"         Using         " link start}
                         @{"         Menus         " link menus}
                         @{"       Copyright       " link copyright}
                         @{"       The author      " link author}
                         @{"        History        " link history}
                         @{"        Thanks         " link thanks}
@endnode
@remark **********************************************************************
@node introduction "Introduction"
@prev introduction
@next requirements
@toc main
  @{b}@{u}Introduction@{ub}@{uu}
    @{b}ACal@{ub} is a small utility which display a 'pretty' calendar on the
  @{b}Workbench@{ub} screen. It has been done for beeing displayed on @{b}MagicWB@{ub}
  screen :  it uses 8 colors brushes and the background color of the
  calendar window is the one used bu MagicCopper,  which allows you
  to show the copper list all around the calendar,  as if the window
  be transparent.
@endnode
@node requirements "Required configuration
@prev introduction
@next installation
@toc main
  @{b}@{u}Required configuration@{uu}@{ub}
  *  @{b}ACal@{ub} runs on every Amiga fitted with 2.04 + OS.
  *  I advise you own  @{b}MagicWB@{ub} or use a 8 or 16 colors Workbench.
  *  I you own WorkBench 2.1+,  @{b}ACal@{ub} will be localized. Internal
  language is french, but english & german catalogs are provided.
  *  You should have @{b}Installer@{ub} to run the installation program.
@endnode
@node installation "Installation"
@prev requirements
@next start
@toc main
  @{b}@{u}Installation@{ub}@{uu}
  Double-click on the installation icon !!!
@endnode
@node start "Running"
@prev installation
@next menus
@toc main
  @{b}@{u}Running@{ub}@{uu}
  @{b}ACal@{ub} may be runned either from CLI or Workbench.
  If you have used the installation program, @{b}ACal@{ub} should be in 
  WBStartup  drawer and will be launched each time the computer reboots.
  CLI syntax is:
  ACal XPOS/K/N,YPOS/K/N,JFONT/K,SMFONT/K,LOCALE/K,BCOLOR/K
  where XPOS, YPOS, JFONT, SMFONT, LOCALE and BCOLOR match the icon @{"TOOLTYPES" link tooltypes}.
  If the program is launched from CLI, it first try to look at the
  TOOLTYPES and then to command line arguments. So these ones have priority
  on the TOOLTYPES.
@endnode
@node menus "ACal's menus"
@prev start
@next apropos
@toc main
  @{b}@{u}Menus@{ub}@{uu}
  Here is the list of menu items :
          @{b}Project@{ub}
            @{"About ...                  [?] " link apropos}
            --------------------------------
            @{"Quit                       [Q] " link quitter}
          @{b}Options@{ub}
            @{"Window to front            [F] " link pplan}
            @{"Window to back             [B] " link aplan}
            @{"  Lock window              [L] " link verrou}
            --------------------------------
            @{"Day font ...                   " link fjour}
            @{"Week/Month font ...            " link fsem}
            --------------------------------
            @{"Save preferences           [S] " link save}
@endnode
@node apropos "About ..."
@prev menus
@next quitter
@toc main
  @{b}@{u}About@{ub}@{uu}
  Displays a @{"Copyright" link copyright} window.
@endnode
@node quitter "Quit"
@prev apropos
@next pplan
@toc main
  @{b}@{u}Quit@{ub}@{uu}
  Ends the program.
  The program may also be ended by double clicking in the window when it is locked.
@endnode
@node pplan "Window to front"
@prev quitter
@next aplan
@toc main
  @{b}@{u}Window to front@{ub}@{uu}
  Puts the window in front of the others.
@endnode
@node aplan "Window to back"
@prev pplan
@next verrou
@toc main
  @{b}@{u}Window to back@{ub}@{uu}
  Puts the window behind the others.
@endnode
@node  verrou "Lock window"
@prev aplan
@next fjour
@toc main
  @{b}@{u}Lock window@{ub}@{uu}
  If this menu item is checked, the window can't be moved.
  This prevents you from moving the window accidently once you've
  positionned it with care and @{"saved the prefs" link save} to disk.
  To move the window, simply un-check this menu item.
@endnode
@node fjour "Day font"
@prev verrou
@next fsem
@toc main
  @{b}@{u}Day font@{ub}@{uu}
  Displays a font requester to choose the day of the month font.
@endnode
@node fsem "Week day/Month font"
@prev fjour
@next save
@toc main
  @{b}@{u}Week day/Month font@{ub}@{uu}
  Displays a font requester to choose the week day and the month font.
@endnode
@node save "Save preferences"
@prev fsem
@next tooltypes
@toc main
  @{b}@{u}Save preferences@{ub}@{uu}
  Allows you to save preferences :
  * window position,
  * Day font,
  * Week day/Month font.
  The preferences are saved in the @{"TOOLTYPES" link tooltypes} of the program
  icon. That way, there's no need for a prefs file in s: or elsewhere :-)
@endnode
@node tooltypes "TOOLTYPES"
@prev save
@next copyright
@toc main
  @{b}@{u}TOOLTYPES@{ub}@{uu}
  @{b}ACal@{ub} uses this tooltypes:
  * @{b}XPOS@{ub} and @{b}YPOS@{ub}    : Window position on the Workbench screen.
  * @{b}JFONT@{ub} and @{b}SMFONT@{ub} : Day and week day/month fonts.
    Fonts are named that way :
    <name><size>
    for instance, for times 18, people will write : ...FONT=times18 
  * @{b}LOCALE@{ub}                    : selects a locale different from the
                                         default one.
  * @{b}BCOLOR@{ub}                    : change background color.
@endnode
@node copyright "Copyright"
@prev tooltypes
@next author
@toc main
  @{b}@{u}Copyright@{ub}@{uu}
    This program is (C)1994,95 by Denis GALIANA; every commercial usage or
  distribution without the *WRITTEN* agreement of the @{"author" link author} is strictly
  forbidden.
  You may copy this program within the following conditions:
     - The *whole* archive must be provided.
     - Any file should have been modified.
     - You must ask for money only for copy and mail fees.
    Though ACal has been intensely tested,  I can't warrant that  ACal is error
  free.  YOU USE THIS PROGRAM AT YOUR OWN RISKS. No responsability or liability
  will be accepted for any damage  that may appear to have resulted from use of
  this program.
    This program is FREEWARE,  that means you may use it freely,  though a mail
  (see  @{"contact the author" link author}), a postcard or $5 to reward the author would be great.
@endnode
@node author "The author"
@next history
@prev copyright
@toc main
  @{b}@{u}The author@{ub}@{uu}
  You can contact me these ways:
  * by e-mail, at the following addresses :
       denis.galiana@ramses.fdn.org          (for mails < 10Kb)
    or denis.galiana@ramses.telesys-innov.fr (for mails > 10Kb)
  * by netmail, at :
    Fidonet  2:320/104.95
    AmigaNet 39:180/1.95
  * by post mail at:
    Denis GALIANA
    30, Rue Henri BARBUSSE
    95870 BEZONS
    FRANCE
  Every comments, suggestions, remarks are welcome.
  Since I'm not an englishman, there may (should :-) be faults in this translation.
  Don't be afraid of sending me remarks about it.
@endnode
@remark Ajout le 16/10/95
@node history  "History"
@prev author
@next thanks
@toc main
  @{b}@{u}History@{ub}@{uu}
  @{b}*  1.2 :@{ub} (1/11/95)
  - Tooltype BCOLOR added. (Suggestion of Fergus O'Hea)
  - Tooltype LOCALE added. (Suggestion of Nils Goers & Pawel Hernik)
  - The program ends on double click in its window (the window being locked)
    (Suggestion of Alain Gaspard)
  - Deutsch doc & installer script translation (thanks to Nils Goers)
  @{b}*  1.1 :@{ub} (22/10/95)
  - While testing the german catalog from Nils Goers, I've found
  two strings that stayed untranslated.
  - English doc.
  - Modification of installer script to take account of the new german
  catalog.
  @{b}*  1.01:@{ub} (16/10/95)
    Correction of the following error:
    Changing of font that was resulting in the window growing was cutting
  some parts of the window if this one was too close from the screen edges.
  @{b}*  1.0 :@{ub} ( 7/10/95)
    First release.
  @{b}@{u}TO DO@{ub}@{uu}
  - a clock
@endnode
@remark Ajout le 22/10/95
@node thanks  "Thanks"
@prev history
@toc main
  @{b}@{u}Thanks@{ub}@{uu}
  To Nils Goers for his german catalog.
  To Nils Goers, Fergus O'Hea, Pawel Hernik and Alain Gaspard for their
  suggestions.
  To Jean Marc Xium
, Etienne Schneider and Eric Gerard for their 'mail'.
@endnode